メインコンテンツまでスキップ
バージョン: DAI 7.4

インストール後の設定

インストール後、DAIサーバーの設定を調整して、組織内での使用に備えることができます。

DAI を使用したシングル サインオンの構成​

DAI でシングル サインオン (SSO) を有効にするには、Enabling Single Sign-On (SSO) Authentication in DAI を参照してください。

自己署名SSL証明書の設定を追加する​

高度なインストールを完了し、自身の証明機関でSSL証明書に署名した場合、インストール後に設定を更新する必要があります。

  1. Windowsのサービスマネージャーを通じてDigital Automation Intelligence Serviceを停止します。

  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。

  3. 以下のエントリをenvキーの下に追加し、ファイルを保存します：

    config.yml
    env:
      REQUESTS_CA_BUNDLE: <ルート証明機関証明書へのパス>

  4. Digital Automation Intelligence Windowsサービスを再起動します。

RabbitMQ 通信を暗号化する​

DAI は、内部のプロセス間通信用のメッセージ ブローカーとして RabbitMQ サーバーを組み込みます。DAI サーバーで HTTPS を有効にすると、すべての Advanced Message Queuing Protocol (AMQP) 通信にトランスポート層セキュリティ (TLS) を使用するように DAI を構成することで、RabbitMQ サーバーへのすべてのトラフィックを暗号化するオプションが提供されます。

注記

DAI サーバーで HTTPS を有効にすると、DAI 7.4 以降で RabbitMQ 通信を暗号化するオプションが利用できるようになります。HTTPS を有効にする方法については、Run an Advanced Install を参照してください。

デフォルトでは、RabbitMQ は暗号化されていない AMQP を使用します。すべての AMQP トラフィックを証明書を使用して暗号化するように RabbitMQ を構成するには、以下のように DAI 構成ファイル (config.yml) を変更する必要があります。

  1. Windowsのサービスマネージャーを通じてDigital Automation Intelligence Serviceを停止します。

  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。

  3. env キーの下に次のエントリを追加してファイルを保存します。

    config.yml
    env:
      INTERNAL_CERT_PATH: <the file path of the certificate, defaults to null>
      INTERNAL_KEY_PATH: <the file path of the certificate key, defaults to null>
      INTERNAL_KEY_PASSWORD: <the password of the certificate key (if required), defaults to null>
      INTERNAL_LISTEN_ADDRESS: <the address that RabbitMQ will listen on, defaults to 127.0.0.1>

  4. Digital Automation Intelligence Windowsサービスを再起動します。

注記

デフォルトでは、すべての RabbitMQ トラフィックは DAI サーバーの内部で行われるため、ローカル マシン (localhost) から出ることはありません。INTERNAL_CERT_PATH を https に使用される外部証明書 (https_cert_path) と同じ値に設定することもできますが、その場合、AMQP トラフィックは証明書で指定されたホストにルーティングされる必要があり、トラフィックはサーバーから出てしまいます。これを行う場合は、INTERNAL_LISTEN_ADDRESS を 0.0.0.0 に設定して、RabbitMQ が外部ソースからのトラフィックを受け入れるようにする必要もあります。また、AMQP トラフィックがファイアウォール (ポート 5673) を通過するように許可する必要もあります。

WindowsでEggplant DAIのポートを変更する​

Eggplant DAIはインストール時にデフォルトでポート8000を割り当てますが、後から別のポートを指定することも可能です：

  1. Windowsのサービスマネージャーを通じてDigital Automation Intelligence Serviceを停止します。
  2. 高度なインストールを繰り返し、ステップ3または4で、設定により新しいポート値を入力します。
  3. インストールが完了したら、Digital Automation Intelligence Windowsサービスを再起動します。

Eggplant DAIアプリケーションサーバーログのローテーションを設定する​

Eggplant DAIアプリケーションサーバーはデフォルトで60日間のログローテーションがありますが、設定ファイルの下でローテーション設定を変更することが可能です：

  1. Windows サービス マネージャーを使用して Digital Automation Intelligence Service を停止します。
  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。
  3. DAI_SERVER_MAX_ROTATED_LOG_COUNT envキーを探します。
  4. ログローテーションカウント番号を変更します。
  5. Digital Automation Intelligence Windows サービスを再起動します。

ログローテーションの挙動​

  • Eggplant DAIでトランザクションログがある場合、ログファイルは毎日生成されます。
  • 新しいログファイルが入ってきたとき、そしてログフォルダが設定値と同数のログファイルを含むときにローテーションが行われます。例えば：
    • DAI_SERVER_MAX_ROTATED_LOG_COUNT: 3を設定します
    • DAIサービスログフォルダは生成されたログファイルを含む、例えば：
      • log.txt.2023-01-01, log.txt.2023-01-03, log.txt.2023-01-04
    • 1月6日に新しいログファイルが作成された場合、このログファイルは最古のログファイルlog.txt.2023-01-01を置き換えます。その結果、次のログファイルが利用可能になります：
      • log.txt.2023-01-03, log.txt.2023-01-04, log.txt.2023-01-06
    • そして新しいログファイルが入ってきたときに再びローテートします。例えば：
      • log.txt.2023-01-04, log.txt.2023-01-06, log.txt.2023-01-07
  • このログローテーション機能は、DAI 6.5で作成されたログファイルのみをローテートします。DAI 6.5以前に作成されたログファイルは手動で管理する必要があります。
  • DAI 6.5のログファイルの名前形式は、DAIの早期バージョンとは異なります。新しいログファイルの名前形式はlog.txt.<タイムスタンプ>です。
  • ログローテーションはPostgreSQL、Nginx、RabbitMQ、Keycloakのログを除外します。これらのログは手動で管理する必要があります。

Eggplant DAI Bug Huntingを設定する​

DAI には、バグの発見に役立つBug Hunting 機能が含まれています。詳細については、Bug Hunting を参照してください。 Bug Hunter は 2 つのモードで実行できます。

  • Bug Hunter Classic、(デフォルト) スタンドアロン プロセスおよび実行可能ファイルです。
  • Bug Hunter Lite。ai-api (DAI API) サービスの下で実行されます。

Bug Hunter Lite は、Bug Hunter Classic に比べてパフォーマンスが大幅に向上しています。ただし、使用するには有効にする必要があります。オプションで DAI_LOG_FACTORS を追加して Bug Hunter に関する情報を取得することもできます。

Bug Hunter Lite を有効にするには:

  1. Windows サービス マネージャーを使用して Digital Automation Intelligence Service を停止します。

  2. C:\ProgramData\Eggplant\Digital Automation Intelligence に移動し、テキスト編集ツールで config.yml ファイルを開きます。

  3. 次のエントリを追加してファイルを保存します。

    config.yml
     env:
      BUG_HUNTER_LITE_ENABLED: 1 <enabled to use Bug Hunter Lite>

    BUG_HUNTER_LITE_ENABLED を 0 に設定すると無効にできます。

    注記

    この設定を以下で説明する DAI_LOG_FACTORS 設定とともに使用して、Bug Hunter に関する情報を取得できます。

  4. Digital Automation Intelligence Windows サービスを再起動します。

DAI モデルのAction優先度を決定する要素のログを有効にする​

DAI は、探索的テストを実行するときに、いくつかの要素を使用してActionが実行される確率を決定します。デフォルトでは、DAI 実行ログにはこれらの要素に関する情報は含まれません。 DAI_LOG_FACTORS 設定を有効にすることで、この情報を取得できます。

注記

DAI_LOG_FACTORS 設定は、DAI 6.5 以降で使用できます。

  1. Windows サービス マネージャーを使用して Digital Automation Intelligence Service を停止します。

  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。

  3. 次のエントリを追加し、ファイルを保存します。

    config.yml
     env:
      DAI_LOG_FACTORS: 1 <enabled to capture information about the Bug Hunter>

    DAI_LOG_FACTORS を 0 に設定すると無効にできます。

  4. Digital Automation Intelligence Windows サービスを再起動します。

スケジュールされたテストアーティファクトの削除の有効化​

デフォルトでは、DAI はテスト成果物を無期限に保存するか、手動で削除するまで保存します。ただし、DAI サーバー設定ファイルで次の表に示す 2 つの環境変数を設定することで、スケジュールに基づいてそれらを削除するように DAI を設定できます。この機能を有効にすると、指定した日数のテスト結果、ログ、およびスクリーンショットのアーティファクトが保存され、その期間が経過すると、指定した昼間 (または夜間) に削除されます。

DAI サーバー設定ファイルには、デフォルトではこれらの変数は含まれていません。この機能を使用するには、手動でファイルに追加する必要があります。変更するファイルの名前は、実行しているDAIサーバー(オンプレミスまたはコンテナデプロイメント)のタイプによって異なります。各 DAI サーバー・インストール・タイプの構成ファイルを変更する手順については、表の後ろに説明します。

注記
  • この機能は DAI 7.3 で実装されました。
  • スケジュール削除を有効にするには、次の両方の環境変数を DAI サーバー設定ファイルに追加する必要があります。
  • 環境変数は大文字と小文字が区別されるため、次の表に示すように入力する必要があります。
  • 'DELETE_RESULTS_TRIGGER_TIME' 値は一重引用符で囲む必要があります。 一重引用符を使用しない場合、DAI Server サービスは再起動されません。
環境変数値説明
DELETE_RESULTS_AFTER_DAYS０デフォルト値 : 0 (無効) テストアーティファクトを削除する前に保存するための日数を指定します。この値は、0,1,10,20,60,120 などの整数である必要があります。この環境変数を DAI サーバー設定ファイルに追加しない場合、または追加してゼロ (0) に設定した場合、スケジュールされた削除が無効になります。この場合、DAI は結果を無期限に保存するか、手動で削除するまで保存します。これら 2 つの変数が設定ファイルに追加されていても、DELETE_RESULTS_AFTER_DAYS が無効になっている場合、DELETE_RESULTS_TRIGGER_TIME 変数も無効になります。
DELETE_RESULTS_TRIGGER_TIME03:00Default Value : 03:00 (3 am) ローカルサーバーの時刻に基づいてDAIが削除を実行する時刻。この変数は 24 時間形式を使用します。これは、デフォルトの午前 3 時や深夜 ('00:00') など、誰もサーバーを使用していない時間に設定することをお勧めします。時間の値は一重引用符で囲んで指定する必要があることに注意してください。DAI Server サービスは、一重引用符を含めない場合、再起動されません。

オンプレミス DAI の Windows インストールの場合​

  1. C:\ProgramData\Eggplant\Digital Automation Intelligence\ に移動し、テキスト編集ツールで config.yml ファイルを開きます。

  2. 次のエントリを 'config.yml' ファイルに追加します。

    config.yml
     env:
      DELETE_RESULTS_AFTER_DAYS: 30 <an arbitrary integer specifying the number of days you want to keep your test artifacts before deleting them; set this to 0 to disable scheduled deletions>

      DELETE_RESULTS_AFTER_DAYS: '03:00' <the time in single quotes at which you want DAI perform the deletion based on the local server time>

  3. 変更を保存します。

  4. DAI Server サービスを再起動して、'config.yml' ファイルの変更で実行します。

  5. スケジュールの変更を確認します。スケジュールの変更を確認するために、ai-apiフォルダのログを参照する必要がある場合があります。

Helm (Garden) コンテナデプロイメントの場合​

  1. Ai-api Helm フォルダーに移動して、'values.yaml' ファイル内の次の変数値を変更します。

  2. 次のエントリを追加します。

    values.yaml
     env:
      DELETE_RESULTS_AFTER_DAYS: 30 <an arbitrary integer specifying the number of days you want to keep your test artifacts before deleting them; set this to 0 to disable scheduled deletions>

      DELETE_RESULTS_AFTER_DAYS: '03:00' <the time at which you want DAI perform the deletion in single quotes>

  3. 変更を保存します。

  4. Garden deployは、'values.yaml'ファイルに次の変更を加えてデプロイします。

  5. Helm インスタンスでログを見つけるのにサポートが必要な場合は、カスタマーサクセスマネージャーまたは当社の [カスタマー Support](mailto:eggplant.support@keysight.com] にお問い合わせください。

SUT および実行環境接続の再試行設定​

テスト ランナーが SUT または実行環境への失敗した接続を自動的に再試行するように構成するには、DAI が再度接続を試行する前に待機する (スリープする) 間隔を指定する必要があります。また、DAI が接続の試行を停止し、テストの実行を停止し、エラーを報告するまでのタイムアウト期間も指定する必要があります。

環境変数値説明
RETRY_SLEEP_INTERVAL_SECONDSMinimum: 1,
Maximum: 100,
Default: 10		テスト ランナーが SUT または実行環境への接続を再試行するまで待機する間隔 (秒単位)。たとえば、RETRY_SLEEP_INTERVAL_SECONDS 変数に 10 秒を指定し、接続が失敗した場合、ランナーは 10 秒待機してから再度接続を試行します。
RETRY_TIMEOUT_SECONDSMinimum: 0,
Maximum: 18000,
Default: 3600		ランナーが接続の試行を停止し (タイムアウト)、テストの実行を停止し、エラーを報告するまでの秒数。この変数を使用してゼロ (0) に設定すると、接続を再試行するオプションが無効になります。

オンプレミス DAI Windows インストール (SUT and Execution Environments) の場合​

  1. C:\ProgramData\Eggplant\Digital Automation Intelligence\ に移動し、テキスト編集ツールで config.yml ファイルを開きます。

  2. config.yml ファイルに次のエントリを追加します。

    config.yml
     env:
      RETRY_TIMEOUT_SECONDS: 3600 <an arbitrary integer specifying the timeout after which a test runner stops trying to connect to a SUT or Execution Environment, stops the test run, and reports an error; set this variable to 0 to disable connection retries.>

      RETRY_SLEEP_INTERVAL_SECONDS: 10 <the interval in seconds you want your test runner to retry connections to a SUT or Execution Environment when the connections fail.>

  3. 変更を保存します。

  4. DAI Server サービスを再起動して、'config.yml' ファイルの変更で実行します。

  5. スケジュールの変更を確認します。スケジュールの変更を確認するために、ai-apiフォルダのログを参照する必要がある場合があります。

Helm (Garden) コンテナ デプロイメント (SUT and Execution Environments) の場合​

  1. Ai-api Helm フォルダーに移動して、'values.yaml' ファイル内の次の変数値を変更します。

  2. 次のエントリを追加します。

    values.yaml
     env:
      RETRY_TIMEOUT_SECONDS: 3600 <an arbitrary integer specifying the timeout after which a test runner stops trying to connect to a SUT or Execution Environment, stops the test run, and reports an error; set this variable to 0 to disable connection retries.>

      RETRY_SLEEP_INTERVAL_SECONDS: 10 <the interval in seconds you want your test runner to retry connections to a SUT or Execution Environment when the connections fail.>

  3. 変更を保存します。

  4. values.yaml ファイルに次の変更を加えて Garden をデプロイします。

  5. Helm インスタンス内のログを見つけるのにサポートが必要な場合は、カスタマー サクセス マネージャーまたは Customer Support にお問い合わせください。

に最終更新